Inside Macintosh: /

QuickDraw 3D RAVE / QuickDraw 3D RAVE Reference

QuickDraw 3D RAVE Routines / Public Draw Context Methods

TQASubmitVerticesTexture

A drawing engine may define a method to submit texture vertices. This method is optional and must be supported only by drawing engines that support texture mapping.

typedef void (*TQASubmitVerticesTexture) (
                                          const TQADrawContext *drawContext,
                                          unsigned long nVertices,
                                          const TQAVTexture *vertices);

drawContext

A draw context.

nVertices

The number of texture vertices pointed to by the vertices parameter.

vertices

A pointer to an array of texture vertices.

DESCRIPTION

Your TQASubmitVerticesTexture function should prepare to render a texture-mapped triangular mesh in the draw context specified by the drawContext parameter using the vertices pointed to by the vertices parameter. The actual triangulation and drawing of the mesh does not occur until an application calls the QADrawTriMeshTexture function.

The calling application is responsible for managing the memory occupied by the texture vertices. Your TQASubmitVerticesTexture function should not copy the vertex data pointed to by the vertices parameter.

SPECIAL CONSIDERATIONS

The TQASubmitVerticesTexture method is optional. If your drawing engine does not support triangle meshes, QuickDraw 3D RAVE decomposes a triangle mesh into individual triangles when the user calls the QASubmitVerticesTexture function to submit a triangle mesh.

There is no QuickDraw 3D RAVE function that an application can use to unsubmit a triangle mesh. Your drawing engine must manage memory in some appropriate manner.